docs: refonte Get Started navigation, retire AI Builder Portal, docum… - #186
Merged
Merged
Conversation
…ent Agent Tasks - Remove AI Builder Portal from the product switcher (content under docs/rde/** untouched), fix the repo-wide missing-prefix link bug and other broken links across the Get Started page group - Fix an AWS IAM policy drift between two snippets (missing servicequotas permission, duplicate dynamodb entry) and convert aws/azure/scaleway installation guides to import their credentials snippets instead of hand- duplicating them, matching the existing gcp.mdx pattern - Restructure Get Started navigation: dedupe pages listed twice in docs.json, dissolve the ambiguous "Quickstart" nav group, fork Installation into Local / Managed Cluster / BYOK, rename quickstart/docker-desktop to quickstart/docker with a redirect - Rebuild aws.mdx onto the same section skeleton as the other three cloud providers (Overview, What Gets Created, Best Practices) and strip marketing language, emojis, and em dashes across the touched pages per AGENTS.md - Realign messaging on introduction.mdx and how-it-works.mdx with qovery.com's current positioning, and rewrite the migration guide around the qovery-onboard skill - Add Agent Tasks documentation (alpha): a Getting Started overview with the ready-made use cases, and a Configuration reference with setup, automations (schedule/webhook triggers, webhook outputs), and dedicated guides for the Incident Analyser and Build & Deployment Optimizer templates Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ✅ Deployment successful! View logs |
qovery-doc-mintlify-proxy | b28d9c5 | Sep 16 2026, 08:47 AM |
navigation.products always renders a dropdown switcher in the header, even with a single product, since that's inherent to the products navigation type rather than tied to how many entries it has. Move the six tabs to navigation.tabs directly, dropping the products wrapper entirely, since there's only one product (Platform) now that AI Builder Portal is gone. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
acarranoqovery
requested changes
Sep 10, 2026
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
All reported issues were addressed
Tip: cubic can generate docs of your entire codebase and keep them up to date. Try it here.
Re-trigger cubic
acarranoqovery
requested changes
Sep 10, 2026
- Move "Agent Tasks" out of the Jobs subcategory into its own Services group, and nest the two use-case guides under an "Examples" subgroup so more can be added over time - Drop the literal prompt text and exact resource/domain values from the Incident Analyser and Build & Deployment Optimizer guides, they will drift as the templates change. Explain what each agent does and how to set it up instead Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
All reported issues were addressed across 3 files (changes from recent commits).
Requires human review: Auto-approval blocked because this review re-detected 1 unresolved issue already reported by Cubic.
Tip: Review your code locally with the cubic CLI to iterate faster.
Re-trigger cubic
docs/files/qovery-iam-aws.json still had the duplicate dynamodb:* entry and was missing servicequotas:GetServiceQuota, the same drift already fixed in the aws-credentials snippets. Anyone using the "Download IAM permissions JSON" link was getting the uncorrected policy. Caught by review. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
…intro - how-it-works.mdx: the architecture diagram SVG still visually shows five product panels (never updated for Agents), so drop the numeric claim from its alt text instead of asserting a count the image doesn't show. Fix the remaining "all five products" Next Steps card to six. The SVG itself needs a real design update to add a sixth panel, out of scope here. - getting-started/agent-tasks.mdx: its Overview paragraph was a verbatim copy of configuration/agent-tasks/overview.mdx's. Rewrite it as a lighter, product-pitch intro and point to the Configuration Reference for the technical definition, so there's one place that owns it. Caught by review. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
RemiBonnet
reviewed
Sep 10, 2026
Co-authored-by: Rémi Bonnet <bonnet.rem@gmail.com>
…orrections - cloud-migration-and-scaling.mdx: qovery-onboard was credited with the full technical migration workflow (analyze codebase, Dockerfiles, databases, deploy), which contradicts this repo's own agent-skills.mdx and ai-agent.mdx, where that workflow belongs to qovery-deploy. qovery-onboard stays the right entry point (context, concept mapping, cluster setup), qovery-deploy now owns the execution steps - introduction.mdx and quickstart.mdx: give the migration use case a "Migrate to Kubernetes" card and move it first, before "Deploy with AI Agent", per review feedback - Qovery's own MCP server is not added automatically, fix the three places that said otherwise (agent-tasks/overview.mdx, agent-tasks/build-deployment-optimizer.mdx, organization.mdx) to say it must be added manually (https://mcp.qovery.com/mcp), and link to the API Policy Token doc for scoped access instead of overclaiming the endpoint itself is read-only - agent-tasks/overview.mdx: reword an output example per review ("For example, to post...") and stop implying Agent Tasks only run once when schedule triggers are documented on the same page Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…y/documentation-v2 into docs-new-messaging-and-agent-tasks
… fix - Scope the API Policy Token mention to the Qovery MCP server specifically in overview.mdx and organization.mdx, it was worded as if it applied to any remote MCP server - overview.mdx: add the actual entry point (environment > New Service > Create new service > Agent use cases) as the first step, with screenshots of the service picker and the agent creation form - incident-analyser.mdx and build-deployment-optimizer.mdx: replace the flat "Setting It Up" bullet list with a full setup-to-first-run walkthrough (repository, Qovery MCP access with propose vs apply permissions, credentials/allowlist, trigger, and how to fire and verify a first run via the webhook URL), per review feedback Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…nd logos - Add Jira Coding Agent and Linear Coding Agent tutorials: setup (repo, provider, optional MCP), and the trigger webhook configured on each platform's automation feature, with a real screenshot for the Jira flow - Split Incident Analyser into two full tutorials, one for incident.io and one for Honeybadger, each self-contained rather than cross- referencing the other, with real screenshots of both platforms' webhook/workflow setup - Fetch and verify real brand logos for incident.io, Honeybadger, Jira, and Linear from their official sources, replacing generic FontAwesome/placeholder icons across the Tutorials and Use Cases card groups - overview.mdx: correct the MCP step (any remote MCP server first, Qovery's own as a secondary Info callout, not added automatically) and add exact Server URL / header format; add a Limits subsection to Execution Mode (1h execution timeout, 3-day cloned environment TTL, 50 iterations per run via MAX_TURNS, 60 clones/hour/org); merge the "Automations" abstraction into direct Triggers and Outputs - getting-started/agent-tasks.mdx: drop the Configuration Reference card duplicating Start from Scratch, add a "Why Run Agent Tasks in Qovery" section explaining the value of running them here specifically Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
All reported issues were addressed across 18 files (changes from recent commits).
Tip: Review your code locally with the cubic CLI to iterate faster.
Re-trigger cubic
RemiBonnet
reviewed
Sep 15, 2026
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Show where the on-demand Trigger (play) button actually is on an agent task's overview page, referenced from Triggers and Outputs. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: Rémi Bonnet <bonnet.rem@gmail.com>
Contributor
There was a problem hiding this comment.
All reported issues were addressed across 18 files (changes from recent commits).
Tip: Review your code locally with the cubic CLI to iterate faster.
Re-trigger cubic
…word Early Preview banner
- Distinguish the automatic (Qovery service as Context -> org-scoped,
read-only MCP via Viewer API token) MCP setup from the manual/custom
path across overview.mdx, incident-analyser.mdx,
incident-analyser-honeybadger.mdx, and build-deployment-optimizer.mdx.
- Split the mandatory "Add a Trigger" step from the optional "Add an
Output" step, and fix the same optional/mandatory mislabeling in
build-deployment-optimizer.mdx.
- Correct the Context picker's wording in getting-started/agent-tasks.mdx
("Add Qovery services from your environment" instead of "environments").
- Extract the verbatim-duplicated setup steps shared by
jira-coding-agent.mdx and linear-coding-agent.mdx into
snippets/coding-agent-{setup-steps,output-step,footer-links}.mdx.
- Extract the Early Preview warning, duplicated across 7 files, into
snippets/agent-tasks-early-preview-warning.mdx, and reword it to read
as a limited early preview rather than "in early development".
- Update organization.mdx's AI Settings section to match: Qovery's own
MCP is now added automatically, not "not added automatically".
- Swap the outdated Linear icon for the current monochrome brand mark.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…y/documentation-v2 into docs-new-messaging-and-agent-tasks # Conflicts: # docs/configuration/agent-tasks/build-deployment-optimizer.mdx # docs/configuration/agent-tasks/incident-analyser.mdx # docs/configuration/agent-tasks/overview.mdx
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
acarranoqovery
approved these changes
Sep 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary by cubic
Retires the AI Builder Portal product entry, restructures the Get Started docs, and adds Agent Tasks (alpha) documentation.
Navigation & Docs
navigation.productswrapper so the header no longer renders a product switcher dropdown.docs.jsonentries, dissolves the Quickstart group, splits Installation into Local / Managed Cluster / BYOK, and renamesquickstart/docker-desktoptoquickstart/dockerwith a redirect.aws.mdx, and extracts the shared Qovery CLI auth snippet.Agent Tasks (Alpha)
Written for commit b28d9c5. Summary will update on new commits.